Skip to main content

TroubleshootingDirect link to Troubleshooting

Use this page when the CLI, GitHub Action, GitLab component, or CircleCI orb fails. For No-Code IDE desktop/login issues, see WebApp Login and VPN Configuration.

Auth and loginDirect link to Auth and login

devassure reports auth / unauthorized / invalid tokenDirect link to devassure-reports-auth--unauthorized--invalid-token

  1. Check connectivity and token status:
devassure ping
  1. If ping fails, log in again:
devassure login

In CI, do not use browser login. Generate a token at app.devassure.io under Account → Settings → Token, store it as DEVASSURE_TOKEN, then:

devassure add-token "$DEVASSURE_TOKEN"

The GitHub Action, GitLab component, and CircleCI orb resolve the token from DEVASSURE_TOKEN (or an explicit token input). If the secret is missing or named differently, auth fails before any test runs.

Web app login shows "Something went wrong"Direct link to Web app login shows "Something went wrong"

  • Load app.devassure.io over https://, not http://.
  • Allow HTTPS / mixed-content in the browser if a corporate policy blocks it.
  • Temporarily disable firewall or antivirus that intercepts HTTPS; if that fixes it, add exceptions for DevAssure hosts.

Full steps: WebApp Login.

Email not verifiedDirect link to Email not verified

Signup sends a verification email. The CLI and extension cannot authenticate until the link is clicked. Check spam if it is missing.

Install and environmentDirect link to Install and environment

CLI not found / devassure is not a commandDirect link to cli-not-found--devassure-is-not-a-command

Install globally. A local npm install does not put devassure on PATH:

npm install -g @devassure/cli
devassure version

Requires Node.js 18+. GitHub Action docs recommend Node.js 24 on CI runners.

GLIBC_2.35 not foundDirect link to glibc_235-not-found

The runner image is too old for the packaged agent runtime.

Use a newer Linux image such as node:24-bookworm or ubuntu:22.04 (or newer). On GitLab, override the component image with inputs.image if your org provides a compatible base.

VPN / corporate networkDirect link to VPN / corporate network

Allow these hosts or CLI install, auth, and runs fail:

  • app.devassure.io
  • nodejs.org
  • registry.npmjs.org
  • googleapis.com
  • tpp-ai-core-cb5f0b000f56.herokuapp.com

See VPN Configuration.

ProxyDirect link to Proxy

If HTTP_PROXY or HTTPS_PROXY is set, the CLI and extension use them. In VS Code / Cursor you can also set DevAssure: Http Proxy / DevAssure: Https Proxy; those override the environment variables.

Project setupDirect link to Project setup

No .devassure/ folderDirect link to no-devassure-folder

The CLI looks for config and tests in .devassure/. Create it with devassure init, or copy the files described in Configuration files.

Environment key missingDirect link to Environment key missing

--environment=staging (or the extension Environment picker) must match a top-level key in test_data.yaml. Missing keys fall back to default. If default.url is also missing, pass --url.

Preview URL in CI is wrong or emptyDirect link to Preview URL in CI is wrong or empty

Place the DevAssure job after the app is built and the preview is up. Pass the live URL:

devassure test --url="$PREVIEW_URL"

GitHub Action / GitLab / CircleCI expose a url input for the same purpose.

CI failuresDirect link to CI failures

GitHub Action cannot resolve the diffDirect link to GitHub Action cannot resolve the diff

Unix-based runners only (Linux or macOS). Windows is not supported.

actions/checkout must set with.ref so the agent can read the code diff.

CircleCI: uncertified orb blockedDirect link to CircleCI: uncertified orb blocked

The DevAssure orb is community-published. Enable Organization Settings → Security → Allow Uncertified Orbs.

Job fails: score below minimum_scoreDirect link to job-fails-score-below-minimum_score

After test / run, the Action/component/orb runs devassure summary --last and compares the score to minimum_score (default 75).

ResultJob
Score ≥ minimum_scorePass
Score below minimum_scoreFail
Score missing or N/AFail
minimum_score ≤ 0 or non-numericValidation skipped

Set minimum_score: 0 to disable the gate. Download the archived report zip from the job artifacts and open it with devassure open-report --archive <path> or the IDE extension.

Tests pass locally, fail or flake in CIDirect link to Tests pass locally, fail or flake in CI

  • CI defaults headless to true for test and run.
  • Raising workers without a larger runner causes CPU/memory contention and false failures. Baseline: 4 vCPU / 16 GB RAM.
  • Confirm DEVASSURE_TOKEN is available to that job (not only to a different environment or unprotected branch).

RuntimeDirect link to Runtime

--filter ignored my --tag / --priority / --folderDirect link to --filter-ignored-my---tag----priority----folder

If --filter is set, it overrides the other filter flags. Put the full expression in --filter or drop --filter.

Session interruptedDirect link to Session interrupted

devassure resume --last
devassure resume --session-id <id>

Cloud Agent sessions queued, not runningDirect link to Cloud Agent sessions queued, not running

You started more sessions than you have agents. Extra sessions wait until an agent is free; they are not dropped. Add agents for more parallelism. See Agents.